package com.example.stuwork.service;

import com.example.stuwork.pojo.Class;

import java.util.List;

/**
 * 班级服务接口
 */
public interface ClassService {
    
    /**
     * 获取所有班级
     *
     * @return 班级列表
     */
    List<Class> findAll();
    
    /**
     * 根据班级ID获取班级信息
     *
     * @param classId 班级ID
     * @return 班级信息
     */
    Class getById(Long classId);
    
    /**
     * 根据院系编号获取班级列表
     *
     * @param deptNumber 院系编号
     * @return 班级列表
     */
    List<Class> findByDeptNumber(String deptNumber);
    
    /**
     * 添加班级
     *
     * @param clazz 班级信息
     * @return 是否成功
     */
    boolean addClass(Class clazz);
    
    /**
     * 更新班级信息
     *
     * @param clazz 班级信息
     * @return 是否成功
     */
    boolean updateClass(Class clazz);
    
    /**
     * 删除班级
     *
     * @param classId 班级ID
     * @return 是否成功
     */
    boolean deleteClass(Long classId);
    
    /**
     * 检查班级是否存在
     *
     * @param deptNumber  院系编号
     * @param grade       年级
     * @param majorCode   专业编码
     * @param classNumber 班级号
     * @return 是否存在
     */
    boolean existsClass(String deptNumber, String grade, String majorCode, String classNumber);
    
    /**
     * 根据关键字搜索班级
     *
     * @param keyword 关键字
     * @return 班级列表
     */
    List<Class> search(String keyword);
} 